home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / xferfaxstats.Z / xferfaxstats
Text File  |  2002-07-08  |  7KB  |  128 lines
  1. XFERFAXSTATS(${MANNUM1_8})           XFERFAXSTATS(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        xferfaxstats - summarize    _H_y_l_a_F_A_X    transmission accounting
  7.  
  8. SSYYNNOOPPSSIISS
  9.        $${{SSBBIINN}}//xxffeerrffaaxxssttaattss [ _o_p_t_i_o_n_s ]    [ _f_i_l_e_s    ]
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.        _x_f_e_r_f_a_x_s_t_a_t_s  is    a command script that prints a summary of
  13.        the _H_y_l_a_F_A_X accounting statistics  for  transmitted  jobs.
  14.        The  statistics    can  be    sorted using one of several keys:
  15.        the sender's account name (default), the    job  tag  (useful
  16.        when  used  for    accounting  purposes), the remote party's
  17.        CSI, the    called phone number, the output    device    used  for
  18.        the  call,  the communication speed, and    the communication
  19.        data  format.   Statistics  are     read    from   the   file
  20.        $${{SSPPOOOOLL}}//eettcc//xxffeerrffaaxxlloogg in the spooling area, unless file
  21.        names are specified on the command line.
  22.  
  23.        The following table is an example of the    output from _x_f_e_r_
  24.        _f_a_x_s_t_a_t_s    (using the default sort    key):
  25.        DDeessttiinnaattiioonn          PPaaggeess   TTiimmee    PPgg//mmiinn     EErrrrss    TTyyppRRaattee      TTyyppDDaattaa
  26.        cadsmith@esd.sgi.com   34      24:05    1.4     0    9600      1-D MR
  27.        ctb@corp.sgi.com          32      20:43    1.5     2    9600      2-D MR
  28.        edmark@esd.sgi.com     42      29:30    1.4     3    9600      1-D MR
  29.        fredc@mfg.sgi.com      157     1:37:52    1.6     0    9600      2-D MR
  30.        jlw@engr.sgi.com          81      57:29    1.4     1    9600      1-D MR
  31.        jlw@wpd.sgi.com          346     3:57:57    1.5     100    9600      1-D MR
  32.        karlton@asd.sgi.com    68      36:57    1.8     0    9600      1-D MR
  33.        kerrie@mfg.sgi.com     48      32:29    1.5     1    9600      2-D MR
  34.        kgraf@mfg.sgi.com      128     1:48:21    1.2     2    9600      1-D MR
  35.        kubey@wpd.sgi.com      264     3:22:13    1.3     6    9600      1-D MR
  36.        loki@wpd.sgi.com          205     2:56:45    1.2     5    9600      2-D MR
  37.        moondog@esd.sgi.com    112     1:23:01    1.3     4    9600      2-D MR
  38.        mpolen@mti.sgi.com     122     1:39:32    1.2     1    9600      1-D MR
  39.        nancyf@mfg.sgi.com     174     2:08:44    1.4     2    9600      2-D MR
  40.        paulh@mfg.sgi.com      56      1:29:24    0.6     0    9600      2-D MR
  41.        richardn@mfg.sgi.com   34      24:42    1.4     1    9600      1-D MR
  42.        rosa@corp.sgi.com      32      28:00    1.1     2    9600      1-D MR
  43.        sam@asd.sgi.com          65      46:25    1.4     5    9600      1-D MR
  44.        seth@asd.sgi.com          34      25:04    1.4     0    9600      1-D MR
  45.        --------------------------------------------------------------------------
  46.        Total              2034    25:49:13    1.3     135
  47.        The first column    column shows the sort key value    used (the
  48.        sender's    identity  here,     but  otherwise     the  destination
  49.        phone  number, remote CSI, etc.).  The _P_a_g_e_s column is the
  50.        total number of good pages transmitted.    The  _t_i_m_e  column
  51.        shows  the  total  amount of time spent transmitting.  The
  52.        _P_g_/_m_i_n column displays the  average  transfer  rate.   The
  53.        _E_r_r_s  column  indicates    how  many errors were encountered
  54.        while transmitting facsimile.  (Note that  this    statistic
  55.        does  not  include  problems  encountered  while    placing    a
  56.        call; e.g.  busy    signals.)  The    _T_y_p_R_a_t_e     column     displays
  57.        the  most  common communication speed with which    facsimile
  58.        were transmitted.  The _T_y_p_D_a_t_a column shows the most  com
  59.        mon  data format    in which facsimile data    were transmitted.
  60.  
  61.        By  default,  account  names  other  than   ``root''   and
  62.        ``guest''  are  automatically mapped to a canonical format
  63.        in which    the host name is removed and identical    addresses
  64.        in  the    same  domain  are  merged together.  For example,
  65.        ``sam@flake.asd.sgi.com''  and  ``sam@foobar.asd.sgi.com''
  66.        are both    mapped to ``sam@asd.sgi.com'' with the associated
  67.        statistics accumulated.    Identical account names     in  dif
  68.        ferent      domains     generate       a     warning;    e.g.
  69.        ``loki@wpd.sgi.com'' and     ``loki@corp.sgi.com''.      If  the
  70.        --nnoommaapp  option is specified, then the above mapping is not
  71.        done and    account    names are not altered.
  72.  
  73. OOPPTTIIOONNSS
  74.        --ccssii**       Sort    output by the remote party's CSI.
  75.  
  76.        --ddeesstt**       Sort    output by the phone number called.
  77.  
  78.        --ddeevv**       Sort    output by the output device (i.e.  modem)
  79.            used.
  80.  
  81.        --ffoorrmmaatt       Sort    output by the negotiated data format.
  82.  
  83.        --jjoobb**       Sort     output    by client-specified job    tag iden
  84.            tifiers.
  85.  
  86.        --nnoommaapp       Supress the normal  account    name  mapping  by
  87.            which   statistics    for   the   ``root''  and
  88.            ``guest'' acounts are merged    and leading host
  89.            name    part of    domain names are stripped.
  90.  
  91.        --sseenndd**       Sort      output   by    sender's   account   name
  92.            (default).
  93.  
  94.        --ssiinnccee _t_i_m_e Show    information only for the facsimile trans
  95.            mitted since    the specified _t_i_m_e; where _t_i_m_e is
  96.            of the form ``MM/DD/YY  HH:MM''  (the  _d_a_t_e(1)
  97.            format string %D %H:%M).
  98.  
  99.        --ssppeeeedd       Sort    output by the signalling rate.
  100.  
  101. DDIIAAGGNNOOSSTTIICCSS
  102.        ``WWaarrnniinngg,, aaddddrreessss ccllaasshh,, ""%%ss"" aanndd ""%%ss""..''  During address
  103.        mapping two mapped  addresses  were  found  for    the  same
  104.        account name.
  105.  
  106.        ``WWaarrnniinngg,, wweeiirrdd    uusseerr aaddddrreessss//nnaammee ""%%ss""..''  During address
  107.        mapping an address was  encountered  that  multiple  ``@''
  108.        symbols in it.
  109.  
  110. NNOOTTEESS
  111.        The  sender  field does not necessarily represent the sub
  112.        mitter's    actual identity.  For example,    it  reflects  the
  113.        value  given  by     the _s_e_n_d_f_a_x(${MANNUM1_8}) ``-f'' option.
  114.        Be cautious that    this field is not utilized  for     auditing
  115.        if the fax user base is not trusted.
  116.  
  117. FFIILLEESS
  118.        ${SPOOL}       spooling area
  119.        etc/xferfaxlogdefault file from which to    read statistics
  120.  
  121. SSEEEE AALLSSOO
  122.        _f_a_x_q(${MANNUM1_8}),    _f_a_x_s_e_n_d(${MANNUM1_8}),       _r_e_c_v_s_
  123.        _t_a_t_s(${MANNUM1_8}), _h_y_l_a_f_a_x_-_l_o_g(${MANNUM4_5})
  124.  
  125.  
  126.  
  127.                May 12, 1996XFERFAXSTATS(${MANNUM1_8})
  128.